home *** CD-ROM | disk | FTP | other *** search
/ The Arsenal Files 8 / The Arsenal Files Collection #8 (Arsenal Computer) (1996).ISO / doorware / arpd131.zip / ARPD.DOC < prev    next >
Text File  |  1996-11-16  |  35KB  |  706 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                           Amateur Radio Packet Door
  17.                                   v.  1.31
  18.  
  19.                  Land-Line BBS to Packet Radio Access System
  20.  
  21.                               Copyright 1994-95
  22.                                       by
  23.  
  24.                           Pass - the - Buck SoftWare
  25.                               Independence, Mo.
  26.  
  27.                                    (W4KGU)
  28.  
  29.  
  30.     Files included in this package:
  31.  
  32.     ARPD.EXE
  33.     ARPD.DOC
  34.     CONFIG.TNC
  35.     DEFAULTS.TNC
  36.     HELP.TNC
  37.     INIT.TNC
  38.     INTRO.TNC
  39.     TNCNODE.TNC
  40.     USERS.TNC
  41.     HISTORY.TXT
  42.     ARPD_OS2.TXT
  43.  
  44.  
  45.          Please  be  sure  all files are included when  you  install  this
  46.     software.    Please  DO NOT distribute this program if ANY  files  are
  47.     missing.
  48.  
  49.          Refer  to  HISTORY.TXT  for  changes  to  system  parameters  and
  50.     operation.
  51.  
  52.          The  A.R.P.D.    program  was developed and tested  on  land-line
  53.     Bulletin Board Systems using the following hardware / software:
  54.  
  55.               386/40 IBM clone
  56.               8250 / 16550 UART serial cards
  57.               PPI 14,400 / 28,800 modems
  58.               RemoteAccess BBS software
  59.               (running under MS Windows)
  60.               MFJ-1270B / 1274C
  61.               Kenwood TM-2530A
  62.  
  63.          While  no two systems are alike,  one similar to the above should
  64.     offer few problems in setting up and running A.R.P.D.
  65.  
  66.          Of  course,   you MUST have a working knowledge of  packet  radio
  67.     operation, your TNC and your BBS software.  Some setup is required and
  68.     the more your system differs from the above,  the more will have to be
  69.     done.
  70.  
  71.          From  the users standpoint,  operation is very simple.   Just hit
  72.     the  key  to access the door,  wait for the TNC to be initialized  and
  73.     then operate just as if they were using it from their computer.   This
  74.     will  require  that you screen the users to be sure they are  familiar
  75.     with  the  operation of your make/model TNC.   If the user panics  and
  76.     drops  carrier  on  the door (many will!),  the system  will  NORMALLY
  77.     recover properly.
  78.  
  79.          Under  some  circumstances the system may feel "All is not  well"
  80.     and  will  make  itself unavailable to other users till reset  by  the
  81.     SysOp.    The  logic  involved  in  this  is  very  simple  but  quite
  82.     intelligent.    When  accessed,  the system writes a file in the  ARPD
  83.     directory called TNCB.USY.   At exit from the door the system attempts
  84.     to  reset the TNC to defaults,  checks the status of the serial  port,
  85.     the phone line,  the temperature and humidity, etc.   If all goes well
  86.     in  this process the system will delete this semaphore file.   At  any
  87.     point  where the system suspects a problem it will exit with the  file
  88.     still in place.
  89.  
  90.          When  the  door is accessed with the TNCB.USY file still  in  the
  91.     directory it will display a screen to the user which explains that the
  92.     TNC is not available and to try again at a future time.  The door will
  93.     exit  back  to  the  BBS.    This makes it possible  to  run  ARPD  on
  94.     multi-line Bulletin Board Systems.  Only one node at a time may access
  95.     the  TNC without concern about the BBS software handling multiple user
  96.     conflicts.
  97.  
  98.          ARPD  also makes a semaphore file to prevent a multiline BBS from
  99.     attempting  simultaneous  access to the CONFIG.TNC file.   While  this
  100.     file  could be left in place under certain extreme conditions,  it  is
  101.     self clearing and will not cause the BBS to hang.   The worst that can
  102.     happen is that a user attempting access would be shown a "Waiting Node
  103.     Access" string for about ten seconds before the process completes.
  104.  
  105.          Under  normal  conditions,  when two nodes attempt access to  the
  106.     TNC,  one will be successful, the other will be told to try again in a
  107.     while.
  108.  
  109.          The  TNCB.USY semaphore file serves another purpose in the normal
  110.     operation of your station.  It allows you to share it with your users.
  111.     A  dedicated packet station is beyond the ability (or willingness)  of
  112.     most  BBS SysOps to supply for their users.   By calling your favorite
  113.     packet  operating software from a batch file such as the one below you
  114.     can take control of the TNC at any time and the users will be informed
  115.     that the TNC is not available for their use.
  116.  
  117.          The  batch  includes a safeguard so that you can't try to  access
  118.     the  TNC  if  it is in use by a BBS caller.   (Handy when  running  in
  119.     Windows!)
  120.  
  121.     REM *** Sample batch to call local packet program
  122.     REM *** Allows use of equipment without BBS user
  123.     REM *** conflict
  124.     @echo off
  125.  
  126.     if exist d:\ra\arpd\tncb.usy goto nocando
  127.     REM *** If TNCB.USY exists local packet program will not be called
  128.  
  129.     copy d:\ra\arpd\tncnode.tnc d:\ra\arpd\tncb.usy
  130.     REM *** Makes a copy of the 1 byte file as TNCB.USY so users
  131.     REM *** will not compete for the serial port
  132.  
  133.     kgucomm.exe
  134.     REM *** Call local packet program
  135.  
  136.     del d:\ra\arpd\tncb.usy goto end
  137.     REM *** This command runs after packet program exits and clears
  138.     REM *** the file so users will have access again
  139.  
  140.     :nocando
  141.     echo Sorry, the TNC is currently in use on the BBS.
  142.     REM *** Displays TNC not available message to YOU!
  143.  
  144.     pause
  145.     :end
  146.  
  147.  
  148.          If  this  batch refuses to operate locally and you know that  the
  149.     door  is  not in use at the moment,  it means that the system has  not
  150.     reset  properly  and  the door is also not available  to  your  users.
  151.     Delete the TNCB.USY file from the ARPD directory and log on to the TNC
  152.     and  check the parameters.   Change any that require changing and then
  153.     exit.
  154.  
  155.          If  you  are not running a multiline BBS and not running under  a
  156.     multi-tasking environment where you could not possibly have a conflict
  157.     with  two programs attempting to use the TNC at once,  you may  delete
  158.     the TNCNODE.TNC file from the ARPD directory.  IF THE TNCNODE.TNC FILE
  159.     IS NOT IN THE ARPD DIRECTORY - TNCB.USY WILL NOT BE CREATED.
  160.  
  161.          Some  SysOps have taken steps to ensure that the TNCB.USY file is
  162.     always  deleted.    Such as adding a line in the calling .BAT file  to
  163.     delete  it.    In earlier versions of ARPD this file could  cause  the
  164.     system to refuse access to users under conditions which didn't warrant
  165.     such  extreme  measures.   Version 1.20 and later will not  have  this
  166.     problem and SysOps should allow ARPD to handle the maintenance of this
  167.     file.    If  you have a problem in your system with this file  causing
  168.     users  to  be locked out of the door you may then take whatever  steps
  169.     necessary  to prevent this from happening.   Please consider the logic
  170.     involved when dealing with multi-tasking environments or multiline BBS
  171.     software.
  172.  
  173.          You  may  also use the door while logged on to the  BBS  locally,
  174.     just as any user can.  You may prefer the look and feel of the door to
  175.     your  present  program,   especially if you are using  a  simple  dumb
  176.     terminal program.
  177.  
  178.          In normal operation,  if the user has ANSI activated on your BBS,
  179.     the screen will be printed in 'DEFCOLOR'  on black until a connect has
  180.     been made.  When a connect has been made the screen will be printed in
  181.     'CONCOLOR'  on black.   The color of the screen indicating the connect
  182.     status of the TNC.   If the user does not have ANSI active on your BBS
  183.     then no color codes are sent.
  184.  
  185.          A  user  actually in the door will time out after the  length  of
  186.     time  specified in the CONFIG.TNC file OR the system time left to  him
  187.     on the BBS, whichever comes first.   In the door, there is no keyboard
  188.     time-out.  The opening and closing screens have a keyboard time-out of
  189.     three  minutes  with a warning beep at two minutes.   If  no  keyboard
  190.     entry takes place within the allotted time, the door will exit back to
  191.     the BBS.
  192.  
  193.          A user dropping carrier will cause the system to attempt to reset
  194.     the  TNC and return to the BBS for normal exit.   It is at this  point
  195.     that  problems may occur.   Encourage your users to NOT hang up on the
  196.     system  if at all possible,  ESPECIALLY if the TNC is connected at the
  197.     time.    Exiting the door in ANY way while the TNC is in the connected
  198.     state  may lead to abnormal program termination.   Use of the CTRLCBRK
  199.     command  in  the CONFIG.TNC if it is applicable to your TNC will  help
  200.     insure the proper resetting of the TNC and normal program termination.
  201.  
  202.     Features:
  203.  
  204.          A.R.P.D.    is  designed to make life easier for a BBS SysOp  who
  205.     wishes  to  make  on air packet available to system users.    Ease  of
  206.     operation was a prime consideration as was low maintenance.
  207.  
  208.          Once   installed  A.R.P.D.    requires  little  attention.    All
  209.     operations  are  handled  automatically by  an  intelligent  operating
  210.     system requiring little specialized knowledge on the part of the SysOp
  211.     or the user.
  212.  
  213.          When  a  user  accesses the door,  the call sign of  the  TNC  is
  214.     changed to that of the user.   This allows him to log on to packet BBS
  215.     stations  and  receive traffic as he would from his own home  station.
  216.     The  call sign is changed back to that of the System Operator on  exit
  217.     from  the  door.    This  has an added advantage of  making  the  user
  218.     responsible for his own actions on the air.
  219.  
  220.          In the event that a station has connected to your TNC from the RF
  221.     end,   a user will not be permitted to enter the door.   Changing  the
  222.     callsign  of the TNC would leave the connected station in limbo.   The
  223.     connect  status  at  door  entry is determined by the  status  of  the
  224.     carrier detect line from the TNC.   Your TNC will,  therefore, need to
  225.     be  set so that DCD reflects the connect status.   On some models this
  226.     is a software setting and a jumper setting on others.  See your manual
  227.     if users get rejected at log-on because of an "external" user.
  228.  
  229.          All  operations are logged in an ASCII text file called  ARPD.LOG
  230.     as well as individual logs for each of the authorized users.
  231.  
  232.          As  the door is accessed the TNC clock is checked and updated  to
  233.     keep  it correct according to system time.   This is also handy in the
  234.     event of a power failure when TNC time might be lost completely.
  235.  
  236.          No SysOp intervention is necessary to tell the A.R.P.D.   program
  237.     or the BBS software that the TNC is off line or powered down.   If the
  238.     TNC is not powered on or is not connected to the serial port, the user
  239.     is notified and the door exits to the BBS.  This off-line condition is
  240.     determined by the condition of the DSR (Data Set Ready)  line from the
  241.     TNC.    DSR MUST be true at log-on.   If you are using a TNC or RS-232
  242.     cable that does not allow this status to be properly reported, you may
  243.     strap  DSR  high  at  the connector and fool the  program.    I  don't
  244.     recommend  this  but  we  are hams and prone  to  experiment.    Since
  245.     A.R.P.D.    now  supports software flow control it should be  possible
  246.     though I haven't tried it.
  247.  
  248.          Any  changes made to TNC settings by you in a local session or by
  249.     the  user  in the door should be canceled on entry/exit to  the  door.
  250.     This  assures  that the system will remain well behaved in both  modes
  251.     whether attended or not.  It also assures that the system is always in
  252.     the same condition the user is familiar with when he logs in.
  253.  
  254.          This  operation  is  handled  automatically by  the  software  if
  255.     properly configed.   On entry to the door, the file INIT.TNC is fed to
  256.     the  TNC  as if written line for line from the keyboard.    This  file
  257.     should  contain  parameters that you would normally change in a  local
  258.     packet  session.   It is particularly handy if you have a local packet
  259.     program  that  loads the TNC with settings optimized for  a  different
  260.     type of operation.
  261.  
  262.          On  exit  from the door,  a COMPLETE set of parameters should  be
  263.     loaded  into the TNC.   This will assure that anything changed in  the
  264.     system  by  a creative user will not be held over for you or the  next
  265.     user.   The file DEFAULTS.TNC is sent to the TNC on exit from the door
  266.     just as though typed from the keyboard line for line.
  267.  
  268.          If you use your TNC on HF or RTTY, several of the settings may be
  269.     changed.    Each of the changed settings should be re-set by INIT.TNC.
  270.     If  you're  not  sure  which settings may be  changed  in  your  local
  271.     operation, you may copy the DEFAULTS.TNC file to the INIT.TNC file and
  272.     do a complete reconditioning of the TNC on both entry and exit.
  273.  
  274.          A.R.P.D.    has  a  feature which was not documented  in  earlier
  275.     versions, though it has been there all along.  Using the <F3> function
  276.     key,   you may enable the local keyboard while a user is online.   The
  277.     user is notified that the SysOp is online in HELP mode.
  278.  
  279.          With  this option you may take a new packet user by the hand  and
  280.     lead  him  through  the  operation  of the TNC  and  even  join  in  a
  281.     conversation   he  is  having  while  connected  to  another  station.
  282.     Pressing  the <F3> key once again will cancel the HELP mode and inform
  283.     the user that you are no longer with him.
  284.  
  285.          The <F4> key will put you in CHAT mode with the user.  He will be
  286.     informed  of  your  presence and if he has ANSI enabled will  see  the
  287.     print  change  to 'SYSCOLOR'  on black.   Keystrokes from him and  the
  288.     local keyboard are displayed on both terminal screens but are not sent
  289.     to the TNC.   TNC output is inhibited (buffered) during this CHAT.  If
  290.     you  chat  long enough the circular buffer structure of  the  A.R.P.D.
  291.     program will allow the contents of the buffer to be overwritten.  This
  292.     is  usually  not a problem unless the user is connected and reading  a
  293.     long ASCII text file.  Again, pressing the <F4> key a second time will
  294.     cancel CHAT mode and return the system to normal operation.
  295.  
  296.          The <F3> and <F4> functions are mutually exclusive.  Entering the
  297.     other  mode will cancel the first.   You need not exit CHAT mode to go
  298.     directly to HELP mode.   Just press the key of the option you wish and
  299.     the transition will take place seemlessly.
  300.  
  301.  
  302.     Technical Stuff:
  303.  
  304.          While the A.R.P.D.   was written around the RemoteAccess (r)  BBS
  305.     software  package,  the only thing actually necessary is that the  BBS
  306.     software  write  an  RA style DORINFO1.DEF file.   This  is  a  fairly
  307.     standard drop file and available with most BBS packages.   If your BBS
  308.     uses  another  drop  file  there are utilities to  change  the  format
  309.     available on most large support BBS's.
  310.  
  311.          A.R.P.D.  runs in a very small amount of memory and it is usually
  312.     not necessary for the BBS software to swap itself out of memory except
  313.     on extremely small systems.   This allows faster loading/unloading for
  314.     the user online.
  315.  
  316.          In  RA a TYPE 7 exit is used to call a batch file.   This is done
  317.     to allow the batch to change the current working directory to the ARPD
  318.     directory.  The menu call in RA is : *C /c d:\ra\arpd.bat
  319.  
  320.          ARPD.BAT is simple:
  321.  
  322.     REM *** Batch file to run A.R.P.D.
  323.     cd d:\ra\arpd
  324.     arpd.exe
  325.     cd d:\ra
  326.  
  327.          You  will,   of  course,  have to change the paths to  suit  your
  328.     system.
  329.  
  330.          In  order  for  your  system to process the batch  file  and  for
  331.     A.R.P.D.  to perform DOS functions the call from the BBS software will
  332.     have it initiate a new instance of COMMAND.COM.  See your BBS software
  333.     documentation to be sure of the procedure for your system.
  334.  
  335.          All of the files supplied with this package are necessary for the
  336.     proper operation of A.R.P.D.  They are :
  337.  
  338.     CONFIG.TNC
  339.  
  340.          ASCII text file describing your system.
  341.  
  342.          SETTING                            |         COMMENT
  343.          ----------------------------------------------------------------
  344.          BBS d:\ra                          | Path to DORINFO1.DEF
  345.          BBSNAME The HamShack BBS           | Name of the BBS
  346.          DLPATH d:\archive\logfiles         | Path to download directory
  347.          BAUD 9600                          | TNC to CPU baud rate
  348.          TNCPORT 3                          | Comm port for TNC
  349.          TNCINT 7                           | Interrupt used by TNC
  350.          PROTOCOL 8N1                       | TNC/CPU mode
  351.          RTSHIGH                            | Required for recent MFJ's
  352.          KAM                                | Required for some KanTronics
  353.          XFLOW                              | XON/XOFF flow control
  354.          NEWLINE 13                         | Specify c/r character
  355.          CTRLCBRK                           | Use 'BREAK' to return CMD:
  356.          DEFCOLOR WHITE                     | Color of normal print
  357.          CONCOLOR LTGREEN                   | Color of connected print
  358.          SYSCOLOR YELLOW                    | Chat mode print color
  359.          TIMELIMIT 60                       | Max time in door
  360.          MYCALL W4KGU                       | TNC call setting command
  361.          MYALIAS HSBBS                      | TNC alias setting command
  362.          MYMCALL W4KGU-1                    | TNC mailbox setting command
  363.          CONNSTRING *** CONNECTED           | TNC connect string
  364.          DISCONNSTRING *** DISCONNECTED     | TNC disconnect string
  365.  
  366.          Only  the left hand portion of the file is included in the actual
  367.     file.  Comments are not allowed in the file.
  368.  
  369.          These  commands may appear in any order and case is not critical.
  370.     The  DLPATH  statement  is  the path to a directory  where  users  may
  371.     download files.   A log of each stations activities are placed in this
  372.     directory  with  the format CALL.LOG.   Mine would be W4KGU.LOG.    It
  373.     would probably be best to allow only participating operators access to
  374.     this directory to keep their files private.  If you don't wish to make
  375.     user  logs  available  online you may make this line the path  to  the
  376.     ARPD directory.  All logs will be written in that area for your review
  377.     or file attaching to the user on a quarterly basis.
  378.  
  379.          The  BAUD,  TNCPORT,  TNCINT and PROTOCOL settings are for use in
  380.     initializing  the  serial port in the computer and have no meaning  as
  381.     far as the RADIO end of the TNC circuit.  PLEASE be sure that the comm
  382.     port  and  interrupt  agree!    Any port from 1 thru 4  is  valid  and
  383.     interrupts  3  thru  7 are valid.   This allows you some  latitude  in
  384.     setting A.R.P.D.  up on a system with non-standard interrupts.
  385.  
  386.          The RTSHIGH is required by late model MFJ TNC's.  If the RTS line
  387.     is pulled low during operation of these units,  no output will be sent
  388.     to the terminal.  If you are using an MFJ and can send to it but don't
  389.     see  anything back,  try adding this line to the CONFIG.TNC file.   If
  390.     you don't need it - don't use it.
  391.  
  392.          KAM tells the system that the TNC is a KANTRONICS.   This will be
  393.     required  on some systems using this equipment.   The best way to tell
  394.     is cycle the power on the TNC and enter the door.  If the DATE/TIME is
  395.     not properly set, add this line to the CONFIG.TNC.
  396.  
  397.          XFLOW  tells  the  system  that you wish  to  use  XON/XOFF  flow
  398.     control.    There  are no parameters,  if it is there,  software  flow
  399.     control  is  enabled.   Hardware flow control is assumed if it is  not
  400.     there.    Not  having XFLOW available was an initial problem for  some
  401.     system operators.  Having it seems to be a greater problem for others.
  402.     PLEASE  BE  SURE  THAT BOTH THE TNC (ALL RELEVANT COMMANDS)   AND  THE
  403.     SERIAL  PORT AGREE ON THE PROTOCOL TO USE TO COMMUNICATE.   THEY  MUST
  404.     _BOTH_ BE SET FOR ONE OR THE OTHER!!
  405.  
  406.          NEWLINE  xx  allows you to change the character sent to  the  TNC
  407.     when  the  <ENTER>  key is pressed.   This value MUST be  in  decimal.
  408.     Either  11  or  13  are valid.   If the line is  not  present  in  the
  409.     CONFIG.TNC 13 ($0D) is used.
  410.  
  411.          CTRLCBRK  will  cause ARPD to send a modem-break  signal  (serial
  412.     spacing  condition for about 3/4 second)  to return control of the TNC
  413.     in place of the $03 character normally sent by CONTROL-C.  On many TNC
  414.     models  this is a SURE way of regaining control whether in converse or
  415.     transparent  mode without regard to timing.   CTRLCBRK is active if it
  416.     is included in the CONFIG.TNC file.   If not present, the ^C character
  417.     is  sent.   With CTRLCBRK active it is not necessary to use the ^C key
  418.     more than one time to return to command mode from any other mode.
  419.  
  420.          DEFCOLOR  - CONCOLOR - SYSCOLOR are the print color configuration
  421.     commands.  Any of these parameters not included in the CONFIG.TNC file
  422.     will  cause  that particular function to use the default value.    The
  423.     command should be followed by a color string from the following list:
  424.  
  425.          BLACK
  426.          RED
  427.          GREEN
  428.          BROWN
  429.          BLUE
  430.          VIOLET
  431.          CYAN
  432.          WHITE
  433.          GRAY
  434.          LTRED
  435.          LTGREEN
  436.          YELLOW
  437.          LTBLUE
  438.          LTVIOLET
  439.          LTCYAN
  440.          LTWHITE
  441.  
  442.          You may have to experiment with these color strings as I am color
  443.     blind  and don't know if the names are exactly correct or not.   I can
  444.     only guarantee that each is a different color.
  445.  
  446.          DEFCOLOR is normal terminal mode print color.
  447.          CONCOLOR is connected mode print color.
  448.          SYSCOLOR is SysOp Chat Mode print color.
  449.  
  450.          The  TIMELIMIT  parameter  is the maximum time the user  will  be
  451.     allowed in the door.  If this time is greater than the time allowed on
  452.     the  system  as reported in the DORINFO1.DEF file it will be  ignored.
  453.     If  it is less than system time left,  the user will have to exit  the
  454.     door  after  this  length of time.   A.R.P.D.   will  allow  users  to
  455.     re-enter the door after exiting.   If you wish to prevent multiple use
  456.     in a 24 hour period, you will have to do it with the BBS software.
  457.  
  458.          MYCALL, MYALIAS and MYMCALL are commands which must be recognized
  459.     by the TNC.  The strings following the commands are sent character for
  460.     character to the TNC as if typed from the keyboard.
  461.  
  462.          CONNSTRING  and DISCONNSTRING are the strings reported by the TNC
  463.     at  connect  and  disconnect.    The strings  MUST  be  character  for
  464.     character  as they would appear on the screen.   A.R.P.D.   uses these
  465.     strings  in conjunction with carrier detect to determine the status of
  466.     the TNC.
  467.  
  468.          This  file is space delimited.   That means that the command name
  469.     and  the parameter must be separated by a space.   No other characters
  470.     are  allowed  to appear in the file.   Everything after the  space  is
  471.     assumed to be part of the parameter and passed to the TNC.
  472.  
  473.  
  474.  
  475.     INTRO.TNC
  476.  
  477.          File  that is displayed to the user after the initial LOGO screen
  478.     that  is hard coded into the program.   This allows you to personalize
  479.     the program to your system.
  480.  
  481.     HELP.TNC
  482.  
  483.          ASCII  text  file that is displayed to users when the TAB key  is
  484.     pressed.  The file will be scrolled 23 lines at a time with a familiar
  485.     "More?  (Y/n)" prompt on the 24th line.
  486.  
  487.     TNCNODE.TNC
  488.  
  489.          A  one  byte file which is used to create the TNCB.USY  semaphore
  490.     file.    Nothing  magic about this file.   Just a space inside a  text
  491.     wrapper.    If it gets lost you can recreate it easily.   If the  file
  492.     does  not  exist the TNCB.USY file will not be created.   Delete  this
  493.     file at your own risk.
  494.  
  495.     INIT.TNC
  496.  
  497.          A  subset  of TNC parameters in an ASCII text file used to  clear
  498.     any changes you may normally make in a "local"  packet session.   This
  499.     file  loads  as  the door is accessed to relieve you of  the  task  of
  500.     resetting  the  changes  at the end of a local session.   Be  sure  to
  501.     include any parameters you might change even occasionally.
  502.  
  503.          This file is passed character for character to the TNC,   just as
  504.     if  you  had typed the commands from the command line.    Any  command
  505.     valid for your TNC may be included here.
  506.  
  507.     DEFAULTS.TNC
  508.  
  509.          Same as the INIT.TNC file but more complete.  This file loads the
  510.     TNC  with  a complete set of parameters to undo any  possible  changes
  511.     made  online  by a user.   If the user gets upset and sets the TNC  to
  512.     beacon  every  ten seconds with rude comments about your  family  tree
  513.     this file will clear it.  Be sure it is a COMPLETE set of parameters.
  514.  
  515.          This  file is passed character for character to the TNC,  just as
  516.     if  you  had typed the commands from the command line.    Any  command
  517.     valid for your TNC may be included here.
  518.  
  519.  
  520.     USERS.TNC
  521.  
  522.          This  is  a list of users who have access to the door.   If  this
  523.     information is missing in this file,  users will not be able to access
  524.     the TNC even if their security level and flag settings allow access to
  525.     the  door.    Users who gain access to the door but are not listed  in
  526.     this file will be shown a screen explaining that they must contact the
  527.     SysOp for complete access to the door.
  528.  
  529.          This file is white space delimited.   That means that you may use
  530.     a space or TAB character(s) between the strings on each line.   It has
  531.     the following format:
  532.  
  533.     LOGON NAME          CALLSIGN            LICENSE CLASS       ACCESS
  534.     ------------------------------------------------------------------
  535.     (example)
  536.  
  537.     Dave Perry          W4KGU-2             EXTRA               FULL
  538.     Craig WA0WPJ        WA0WPJ-4            EXTRA               FULL
  539.  
  540.          Use  of the TAB character will keep the file looking neat but one
  541.     space is all that is really necessary:
  542.  
  543.     Dave Perry W4KGU-2 EXTRA FULL
  544.     Craig WA0WPJ WA0APJ-4 EXTRA FULL
  545.  
  546.     would also work.
  547.  
  548.          Please  note the use of the SSID in the callsign field.   This is
  549.     will  prevent the users home station from responding at the same  time
  550.     should  it  be on the same frequency.   Have your users pick  an  SSID
  551.     number  that  will  not conflict with any presently in  use  on  other
  552.     transmitters.
  553.  
  554.          At  this  time only the first two fields are in use  by  A.R.P.D.
  555.     but  the  others  are  included for planned future  expansion  of  the
  556.     program.   With radios becoming more and more computer aware it may be
  557.     possible  in  the  future that users online can pick  frequencies  and
  558.     bands.   It will then be necessary to insure that only those valid for
  559.     a given user are allowed.
  560.  
  561.          If you turn the power off to the TNC,  A.R.P.D.   will sense this
  562.     and inform the user that the TNC is not available for use and ask them
  563.     to  please  try  at a later time.   You do not have to  change  access
  564.     levels or flags when taking the TNC off line.
  565.  
  566.          The  TNC clock is updated at each access to the door.   This will
  567.     keep the TNC time in agreement with the system clock.
  568.  
  569.          A.R.P.D.    uses a direct control method of serial port operation
  570.     both  on the BBS and the TNC ports.   If a FOSSIL driver is present in
  571.     the system it is ignored for the time the door is in operation.   This
  572.     communications driver has been in use and improved over 5 years as the
  573.     basis  for  all  door programs written by PTB SoftWare and in  use  by
  574.     other  software authors for remote system access.   It works very well
  575.     in DOS, Windows and in a DOS box under OS/2.
  576.  
  577.          In  the  ALPHA test machine here the port is set at 9600 for  TNC
  578.     operations and at 57,600 for the 28.8kb modem.   Internal buffering in
  579.     the program and the TNC are sufficient for handling 28.8 user connects
  580.     to  300 baud connects at the radio port with no loss of data in either
  581.     direction under normal keyboarding conditions.
  582.  
  583.     Installation:
  584.  
  585.          Installation  is  simple.   Just make a directory under your  BBS
  586.     software directory and place all the files included in this directory.
  587.  
  588.          Using  an ASCII text editor,  edit each of the files as necessary
  589.     for your installation.
  590.  
  591.          Make  a menu selection on your BBS that will allow the system  to
  592.     shell out to the A.R.P.D.  program.
  593.  
  594.          Write a batch file to change the current working directory to the
  595.     ARPD directory and call the program.
  596.  
  597.          Remember  that the comm port and interrupt settings are  hardware
  598.     settings.    Changing  the  comm  port and interrupt  numbers  in  the
  599.     CONFIG.TNC file won't make it so.  These are just pointers to hardware
  600.     that must exist on your system when installed.
  601.  
  602.          The  Land-Line  comm port MUST have RTS/CTS  DSR/DTR  handshaking
  603.     enabled.    You DO NOT have the option of XON/XOFF protocol for the LL
  604.     port.    Some  of  your users may have improperly  configured  modems.
  605.     About   15%  of  the  users  on  my  system  have  pass-thru  XON/XOFF
  606.     configured.    Most  users aren't aware that they can change that  and
  607.     many  of those will not be up to the task once made aware.   Pass-thru
  608.     XON/XOFF  should not be a problem in the door.   It may however  cause
  609.     some problems on entry and exit.  Users having problems at these times
  610.     need to be informed that modems usually come with manuals.
  611.  
  612.          For  ARPD.EXE to work the first time,  it MUST be able to talk to
  613.     the  TNC.   If the parameters you have set in CONFIG.TNC do not  match
  614.     the modem parameters (protocol - handshaking - etc.), the program will
  615.     not  initialize  the TNC.   Use a favorite packet or comm  program  to
  616.     "condition"   the TNC.   Usually it is best to put in BBRAM in the TNC
  617.     the values that will be used in the DEFAULTS.TNC file.
  618.  
  619.          If your TNC does not recognize the command strings:
  620.  
  621.          MYCALL
  622.          MYALIAS
  623.          DA xxxxxxxx
  624.  
  625.     then it will NOT work with this version of ARPD.EXE.
  626.  
  627.          I  write better programs than documents.   All of the information
  628.     you  need to install and use the program is here,  it just may not  be
  629.     formatted  to your taste.   Read the entire document carefully and you
  630.     should be able to install and use it in short order.
  631.  
  632.  
  633.     LEGAL Stuff:
  634.  
  635.          This program is copyrighted software with a limited license to be
  636.     used  for  its intended purpose without charge.   It may not be  sold,
  637.     altered or included in any software or hardware package for any reason
  638.     without the express written consent of the author.   (This will insure
  639.     you have the latest version!)
  640.  
  641.          The  author can accept no liability for the use or the misuse  of
  642.     this  program  or any damage resulting from such use.   If you  cannot
  643.     accept  the  terms of this condition and use this program at your  own
  644.     risk then DO NOT USE THIS SOFTWARE.
  645.  
  646.          You  MUST  be  a  licensed Amateur Radio  Operator  to  use  this
  647.     software.   Use of this program to control on air transmissions may be
  648.     a violation of Federal Law.  You should check with the FCC for planned
  649.     operation  on certain bands/frequencies.   The author cannot guarantee
  650.     that  under  certain  circumstances  and conditions the  use  of  this
  651.     program  on bands/frequencies where unattended operation is prohibited
  652.     will not result in a citation for violation.  The author can accept NO
  653.     responsibility for such operation.  Please check with your closest FCC
  654.     office if you have any question.
  655.  
  656.          FCC rules and regulations Part 97.5(e) require the posting of the
  657.     station license at the transmitter sight.  It would be prudent to have
  658.     each  user  supply  a  photocopy/fax of  their  license  for  posting.
  659.     Remember,   when the user logs onto the system the callsign is changed
  660.     to his and becomes his transmitter for the duration of use.   The user
  661.     is  in effect using his own station under wire-line remote control  as
  662.     permitted by FCC regulations.
  663.  
  664.          There is no charge for this program.  I would appreciate a QSL or
  665.     netmail  to know that you are using it.   I would also appreciate  any
  666.     feedback you may have on its operation and,  of course, the inevitable
  667.     bug reports.   I cannot guarantee to update the software and accept no
  668.     obligation for future releases.  This is FREE, you know!
  669.  
  670.          If you are using this program in a system substantially different
  671.     from the one outlined above, I would appreciate a note letting me know
  672.     of any special steps or settings you have made to make it function for
  673.     you.    I will pass these along to others who may have similar systems
  674.     or problems with particular pieces of hardware/software.
  675.  
  676.     Kantronics(r) users please note:
  677.  
  678.          This  software is NOT compatible with Kantronics(r)  products and
  679.     the  manufacturer has refused to cooperate in supplying specifications
  680.     to  enable  me  to make it so.   I will not be able  to  support  this
  681.     program for users who have the Kantronics(r)  KPC(r)  line of Terminal
  682.     Node Controllers.   Don't even bother to ask.  I was treated so rudely
  683.     by  this company on the telephone that I have absolutely NO desire  to
  684.     support the use of their products.
  685.  
  686.          All  Hardware and Software products mentioned in this document by
  687.     name are the sole exclusive property of their manufacturers.
  688.  
  689.  
  690.          You may reach me at any of the following addresses:
  691.  
  692.     sysop@f19.n280.z1.fidonet.org                     InterNet
  693.  
  694.     Dave Perry                                        FidoNet
  695.     1:280/19
  696.  
  697.     Dave Perry                                        SnailMail
  698.     W4KGU
  699.     Current Callbook Address
  700.  
  701.  
  702.  
  703.                                      -73-
  704.  
  705.  
  706.